home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / rumor13.zip / RUMOR.DOC < prev    next >
Text File  |  1992-05-14  |  6KB  |  119 lines
  1.  
  2.  
  3.    ─────────────────────────────────────────────────────────────────────────
  4.  
  5.            [ Rumor/Quote File Creator v1.3 for T.A.G. v2.6 and above ]
  6.             (C)May 1992 - Written by Paul Deeds - All Rights Reserved
  7.  
  8.  ─────────────────────────────────────────────────────────────────────────────
  9.  
  10.   Purpose: Converts T.A.G. v2.6 questionarre  answer files with one  line per
  11.            user name to T.A.G. v2.6 format quotation file.  This allows users
  12.            to quickly  add to your rumor or quote file using  built in T.A.G.
  13.            system commands.
  14.  
  15.   Usage: RUMOR <configuration file name>
  16.  
  17.   With the release of version 2.6 of T.A.G. a versitile and powerful feature
  18.   has been added.   Few people understand the capabilities of this addition,
  19.   thus it is little  used.   This program  will help you  take advantage  of
  20.   T.A.G.'s ability to display a random text strings,  as chosen from a file.
  21.   First, to save you time, I will quote the pertinent  information from the
  22.   T.A.G. v2.6 update documentaion:
  23.  
  24.    Bottom of page 27:
  25.  
  26.       ***  A file  called TAGQUOTE.* may  now be created to  produce an "Your
  27.            quote for the day  is:" during the  logon process just before  the
  28.            bulletin section appears (if active).
  29.  
  30.    Bottom of page 34:
  31.  
  32.       Function  :    Generate random message
  33.       PKey      :    "8"
  34.       PData     :    <Filename>
  35.  
  36.            <Filename>     MS-DOS filename of the message file
  37.  
  38.       This  command chooses  a random  message from  the specified  file and
  39.       displays it to  the user.  The  file is in standard ASCII  format with
  40.       one blank line separating each message.  If the first line of the file
  41.       begins with "~" it is used as the header instead of the standard quote
  42.       of  the day header.   Due to the algorithm  used, longer quotes have a
  43.       better chance of being chosen than shorter ones.
  44.  
  45.  
  46.   Amazing what you can learn from reading the documentation.  Ok, so now you
  47.   want to know how to use this program to take advantage of the new feature.
  48.   I will go step by step through a simple set up, then briefly describe some
  49.   other possibilities.
  50.  
  51.   1. Copy the RUMOR.CFG and RUMOR.EXE file into your main BBS directory.
  52.   2. Edit the RUMOR.CFG file, the explantion of each of the three lines
  53.      is contained at length in the configuration file.
  54.   3. Add four commands to a menu (main for me) as follows:
  55.  
  56.       A) Pkey: "?"               This command will be called by the user
  57.          PData: @RUMORQ.MSG      when they  want to add a rumor/quote to
  58.                                  your file. Set the security information
  59.          This command needs      as you see fit.   You will need to copy
  60.          to  be  linked  to      the RUMORQ.MSG  file  included  in this
  61.          the next command.       archive  to your  alternate  data files
  62.                                  directory.
  63.  
  64.       B) Pkey: ":"               This  command  should  be  linked  from
  65.          Pdata: RUMOR RUMOR.CFG  command  (A),  it  shells  to  DOS  and
  66.                                  processes the rumor file.
  67.          This command needs
  68.          to hidden.
  69.  
  70.       C) Pkey: "8"               This   command,   when   executed  will
  71.          Pdata: RUMOR.TXT        display  a  random   quote   from   the
  72.                                  RUMOR.TXT file located in the main data
  73.                                  files directory.
  74.  
  75.       D) Pkey: "!"               Set  this  command so  that it is  only
  76.          Pdata: RUMORA.TXT       available to Co-Sysops or very  trusted
  77.                                  users.   It  displays  the  entire  raw
  78.                                  questionarre  file  and  will show  the
  79.                                  user name/time date of each quote/rumor
  80.                                  that was added.
  81.  
  82.   4. Test everything out, if it didn't work you did something wrong, go
  83.      back to step #1 and check your work.
  84.  
  85.   5. After you have added answered the questionnare once use a text editor
  86.      and add a line to the top of your RUMORA.TXT file so that it looks
  87.      like this:
  88.  
  89. ----------------------------< top of file >-------------------------------
  90. ~
  91. Dirty #1                                     11:41 am  Sun Mar 08, 1992
  92.   This is a rumor.
  93. Tom Smith #28                                12:36 pm  Sun Mar 08, 1992
  94.   This is another.
  95.  
  96.      The "~" charcater replaces the standard "Your quote for the day is:"
  97.      line with a blank line, or whatever you type after the "~" character.
  98.  
  99.   6. Their are obviously many ways that you could expand on the simple set
  100.      up above.   I have my system set up so that each  time a user changes
  101.      menus it displays a quote/rumor. This can be done very easily through
  102.      linked  commands.   I  also  setup a command off the main  menu  that
  103.      allows users to view the entire  processed quote file.   I will leave
  104.      the rest of the possibilities to you.
  105.  
  106.   I tried to make this documentation as complete as possible.   Hopefully
  107.   even the most novice  sysop could get  through them.   You veterans may
  108.   have been insulted by the detail I went into for this relatively simple
  109.   program, but I aimed at the lowest common denominator.
  110.  
  111.   This program  is released as free ware,  please  distribute it with all
  112.   the files that are included in this archive.   If you find this program
  113.   useful please drop me  some netmail and let me know  that you are using
  114.   it.  I am always open to suggestions  and can be contacted  through the
  115.   T.A.G. echos or on my board:
  116.  
  117.                Dirty Deeds - 313/646-3776 - 1:120/267@fidonet
  118.  
  119.